Skip to content

fix: reword meta copy that compares npmx to npmjs.com#2088

Open
serhalp wants to merge 1 commit intomainfrom
serhalp/reword-comparison-copy
Open

fix: reword meta copy that compares npmx to npmjs.com#2088
serhalp wants to merge 1 commit intomainfrom
serhalp/reword-comparison-copy

Conversation

@serhalp
Copy link
Member

@serhalp serhalp commented Mar 15, 2026

🔗 Linked issue

N/A

🧭 Context

We intend to describe npmx for what it is and intends to be, not for how it compares to alternatives.

We already made such adjustments many weeks ago, but a couple slipped through the cracks.

📚 Description

Reword the last remaining "better than..." wordings.

I believe this also supersedes #1988

@vercel
Copy link

vercel bot commented Mar 15, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs.npmx.dev Ready Ready Preview, Comment Mar 15, 2026 2:34pm
npmx.dev Ready Ready Preview, Comment Mar 15, 2026 2:34pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
npmx-lunaria Ignored Ignored Mar 15, 2026 2:34pm

Request Review

@github-actions
Copy link

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
i18n/locales/en.json Source changed, localizations will be marked as outdated.
i18n/locales/fr-FR.json Localization changed, will be marked as complete.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@codecov
Copy link

codecov bot commented Mar 15, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 15, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ebadf104-ff46-4c6a-b225-3a487a4b105f

📥 Commits

Reviewing files that changed from the base of the PR and between 4422cba and ad73a5b.

📒 Files selected for processing (3)
  • docs/content/1.getting-started/1.introduction.md
  • i18n/locales/en.json
  • i18n/locales/fr-FR.json

📝 Walkthrough

Walkthrough

This pull request updates introductory content and localisation strings across the npmx.dev project. The changes include revisions to the English introduction documentation to adopt more action-oriented language, and updates to English and French locale files. The terminology shifts from describing features as "better" to "great" or "fast, modern," and clarifies descriptions of the platform's purpose and developer experience focus. All changes are content-based with no modifications to code logic or exported entities.

Possibly related PRs

Suggested reviewers

  • danielroe
  • graphieros
  • userquin
🚥 Pre-merge checks | ✅ 1
✅ Passed checks (1 passed)
Check name Status Explanation
Description check ✅ Passed The pull request description clearly relates to the changeset, explaining the intent to reword comparative language and remove 'better than' comparisons throughout documentation and locale files.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch serhalp/reword-comparison-copy
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@serhalp serhalp requested review from graphieros and patak-cat and removed request for patak-cat March 16, 2026 11:36
Copy link
Contributor

@graphieros graphieros left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a few suggestions to make some formulations more catchy.

## What is npmx.dev?

npmx.dev is a fast, modern browser for the npm registry. It doesn't aim to replace [npmjs.com](https://www.npmjs.com/), but provides a better UI and developer experience for browsing packages, viewing documentation, and exploring code.
npmx.dev is a fast, modern browser for the npm registry, focused on a great developer experience for browsing packages, viewing documentation, and exploring code.
Copy link
Contributor

@graphieros graphieros Mar 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The start of the sentence repeats line 8

Suggestion, just synonyms: Engineered for browsing performance and modern usability for the npm registry... (or something to that end)

"title": "About",
"heading": "about",
"meta_description": "npmx is a fast, modern browser for the npm registry. A better UX/DX for exploring npm packages.",
"meta_description": "npmx is a fast, modern browser for the npm registry. A great UX/DX for exploring npm packages.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would propose epithets like 'refined', 'seamless' instead of 'great'

"what_we_are": {
"title": "What we are",
"better_ux_dx": "better UX/DX",
"better_ux_dx": "great UX/DX",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here

"description": "npmx is a {betterUxDx} for the npm package registry and tooling. We provide a fast, modern interface for exploring packages, with features like dark mode, keyboard navigation, code browsing, and connections to alternative registries like {jsr}.",
"admin_description": "We also aim to provide a better {adminUi} for managing your packages, teams, and organizations — all from the browser, powered by your local npm CLI."
"description": "npmx is a {betterUxDx} for the npm package registry and tooling. We strive to provide a fast, modern interface for exploring packages, with features like dark mode, keyboard navigation, code browsing, and connections to alternative registries like {jsr}.",
"admin_description": "We also aim to provide a great {adminUi} for managing your packages, teams, and organizations — all from the browser, powered by your local npm CLI."
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here

"not_package_manager": "Not a package manager.",
"not_registry": "Not a registry.",
"registry_description": "We don't host packages. We're just a better way to browse them.",
"registry_description": "We don't host packages. We're just a fast, modern way to browse them.",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can drop the 'just' to make the sentence more catchy

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants